﻿<!DOCTYPE HTML>
<html lang="zh">
<head>
<title>数学函数 - 语法 &amp; 使用 | AutoHotkey v2</title>
<meta name="description" content="Functions 遍历 performing various mathematical operations such as rounding, exponentiation, squaring, etc." />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
<script type="text/javascript">$(function(){0<=window.navigator.userAgent.toLowerCase().indexOf("ucbrowser")&&CaoNiMaDeUc()})</script>
</head>
<body>

<h1>数学函数</h1>
<p>用于执行各种数学运算的函数, 如四舍五入, 取幂, 平方等.</p>

<h2 id="toc">目录</h2>
<ul>
  <li><a href="#General">常规数学</a>
    <ul>
      <li><a href="#Abs">绝对值</a>: 返回数字的绝对值.</li>
      <li><a href="#Ceil">向上取整</a>: 返回数字向上到的最近的整数.</li>
      <li><a href="#Exp">指数函数</a>: 返回 e 的 <em>N</em> 次方.</li>
      <li><a href="#Floor">向下取整</a>: 返回数字向下到的最近的整数.</li>
      <li><a href="#Log">对数</a>: 返回数字的对数(10 为底).</li>
      <li><a href="#Ln">自然对数</a>: 返回数字的自然对数(e 为底).</li>
      <li><a href="#Max">最大值</a>: 返回一个或多个数字的最大值.</li>
      <li><a href="#Min">最小值</a>: 返回一个或多个数字的最小值.</li>
      <li><a href="#Mod">余数</a>: 返回除法的余数.</li>
      <li><a href="#Round">四舍五入</a>: 返回四舍五入到 <em>N</em> 位小数的数字.</li>
      <li><a href="#Sqrt">平方根</a>: 返回数字的平方根.</li>
    </ul>
  </li>
  <li><a href="#Trigonometry">三角函数</a>
    <ul>
      <li><a href="#Sin">正弦</a>: 返回一个数字的三角正弦值.</li>
      <li><a href="#Cos">余弦</a>: 返回数字的三角余弦值.</li>
      <li><a href="#Tan">正切</a>: 返回数字的三角正切值.</li>
      <li><a href="#ASin">反正弦</a>: 返回以弧度表示的反正弦值(其正弦值为指定的数字).</li>
      <li><a href="#ACos">反余弦</a>: 返回以弧度表示的反余弦值(其余弦值为指定的数字).</li>
      <li><a href="#ATan">反正切</a>: 返回以弧度表示的反正切值(其正切值为指定的数字).</li>
    </ul>
  </li>
  <li><a href="#Errors">错误处理</a></li>
</ul>

<h2 id="General">常规数学</h2>

<h3 id="Abs">绝对值</h3>
<p>返回 <em>Number</em> 的绝对值.</p>
<pre class="Syntax">Value := <span class="func">绝对值</span>(Number)</pre>
<p>返回值的类型和 <em>Number</em> 的一样(整数或浮点数).</p>
<pre class="NoIndent">信息框 绝对值(-1.2) <em>; 返回 1.2</em></pre>

<h3 id="Ceil">向上取整</h3>
<p>返回 <em>Number</em> 向上取整后的整数(不含任何 .00 后缀).</p>
<pre class="Syntax">Value := <span class="func">向上取整</span>(Number)</pre>
<pre class="NoIndent">信息框 向上取整(1.2)  <em>; 返回 2</em>
信息框 向上取整(-1.2) <em>; 返回 -1</em></pre>

<h3 id="Exp">指数函数</h3>
<p>返回 e(近似值为 2.71828182845905) 的 <em>N</em> 次幂.</p>
<pre class="Syntax">Value := <span class="func">指数函数</span>(N)</pre>
<p><em>N</em> 可以为负数或十进制小数. 要计算 e 之外的数字的幂, 请使用 <a href="../Variables.htm#pow">** 运算符</a>.</p>
<pre class="NoIndent">信息框 指数函数(1.2) <em>; 返回 3.320117</em></pre>

<h3 id="Floor">向下取整</h3>
<p>返回 <em>Number</em> 向下取整后的整数(不含任何 .00 后缀).</p>
<pre class="Syntax">Value := <span class="func">向下取整</span>(Number)</pre>
<pre class="NoIndent">信息框 向下取整(1.2)  <em>; 返回 1</em>
信息框 向下取整(-1.2) <em>; 返回 -2</em></pre>

<h3 id="Log">对数</h3>
<p>返回 <em>Number</em> 的对数(10 为底).</p>
<pre class="Syntax">Value := <span class="func">对数</span>(Number)</pre>
<p>结果为浮点数. 如果 <em>Number</em> 为负数, 则抛出异常.</p>
<pre class="NoIndent">信息框 对数(1.2) <em>; 返回 0.079181</em></pre>

<h3 id="Ln">自然对数</h3>
<p>返回 <em>Number</em> 的自然对数(e 为底).</p>
<pre class="Syntax">Value := <span class="func">自然对数</span>(Number)</pre>
<p>结果为浮点数. 如果 <em>Number</em> 为负数, 则抛出异常.</p>
<pre class="NoIndent">信息框 自然对数(1.2) <em>; 返回 0.182322</em></pre>

<h3 id="Max">最大值</h3>
<p>返回一个或多个数字的最大值.</p>
<pre class="Syntax">Value := <span class="func">最大值</span>(Number1 <span class="optional">, Number2, ...</span>)</pre>
<pre class="NoIndent">信息框 最大值(2.11, -2, 0) <em>; 返回 2.11</em></pre>
<p>你还可以指定一个<a href="../Functions.htm#Variadic">可变参数</a>来比较数组中的多个值. 例如:</p>
<pre class="NoIndent">数组 := [1, 2, 3, 4]
信息框 最大值(数组*) <em>; 返回 4</em>
</pre>

<h3 id="Min">最小值</h3>
<p>返回一个或多个数字的最小值.</p>
<pre class="Syntax">Value := <span class="func">最小值</span>(Number1 <span class="optional">, Number2, ...</span>)</pre>
<pre class="NoIndent">信息框 最小值(2.11, -2, 0) <em>; 返回 -2</em></pre>
<p>你还可以指定一个<a href="../Functions.htm#Variadic">可变参数</a>来比较数组中的多个值. 例如:</p>
<pre class="NoIndent">数组 := [1, 2, 3, 4]
信息框 最小值(数组*) <em>; 返回 1</em></pre>

<h3 id="Mod">余数</h3>
<p>取模运算. 返回 <em>Dividend</em> 除以 <em>Divisor</em> 的余数.</p>
<pre class="Syntax">Value := <span class="func">余数</span>(Dividend, Divisor)</pre>
<p>结果的正负号总是与第一个参数相同. 如果任意一个输入是浮点数, 则结果也是浮点数. 如果第二个参数为 0, 则抛出异常.</p>
<pre class="NoIndent">信息框 余数(7.5, 2) <em>; 返回 1.5 (2 x 3 + 1.5)</em></pre>

<h3 id="Round">四舍五入</h3>
<p>返回 <em>Number</em> 四舍五入到 <em>N</em> 位小数的数字.</p>
<pre class="Syntax">Value := <span class="func">四舍五入</span>(Number <span class="optional">, N</span>)</pre>
<p>如果 <em>N</em> 省略或为 0, <em>Number</em> 四舍五入到整数:</p>
<pre class="NoIndent">信息框 四舍五入(3.14)    <em>; 返回 3</em></pre>
<p>如果 <em>N</em> 为正数, <em>Number</em> 四舍五入到 <em>N</em> 位小数:</p>
<pre class="NoIndent">信息框 四舍五入(3.14, 1) <em>; 返回 3.1</em></pre>
<p>如果 <em>N</em> 为负数, <em>Number</em> 四舍五入到小数点左边 <em>N</em> 位:</p>
<pre class="NoIndent">信息框 四舍五入(345, -1) <em>; 返回 350</em>
信息框 四舍五入(345, -2) <em>; 返回 300</em></pre>
<p>如果 <em>N</em> 省略或小于 1, 结果为整数. 否则, 结果为精确到 <em>N</em> 位小数的数字字符串. 如果需要纯数字, 只需对 四舍五入 的返回值执行另一个数学运算; 例如: <code>四舍五入(3.333, 1)+0</code>.</p>

<h3 id="Sqrt">平方根</h3>
<p>返回 <em>Number</em> 的平方根.</p>
<pre class="Syntax">Value := <span class="func">平方根</span>(Number)</pre>
<p>结果为浮点数. 如果 <em>Number</em> 为负数, 则抛出异常.</p>
<pre class="NoIndent">信息框 平方根(16) <em>; 返回 4</em></pre>

<h2 id="Trigonometry">三角函数</h2>
<p class="note"><strong>注意</strong>: 要将弧度值转换为度数值, 可用弧度值乘以 180/pi(约为 57.29578). 要将度数值转为弧度值, 可用度数值乘以 pi/180(约为 0.01745329252). pi(约为 3.141592653589793) 的值为 4 乘以 1 的反正切.</p>

<h3 id="Sin">正弦</h3>
<p>返回 <em>Number</em> 的正弦.</p>
<pre class="Syntax">Value := <span class="func">正弦</span>(Number)</pre>
<p><em>Number</em> 必须为弧度值.</p>
<pre class="NoIndent">信息框 正弦(1.2) <em>; 返回 0.932039</em></pre>

<h3 id="Cos">余弦</h3>
<p>返回 <em>Number</em> 的余弦值.</p>
<pre class="Syntax">Value := <span class="func">余弦</span>(Number)</pre>
<p><em>Number</em> 必须为弧度值.</p>
<pre class="NoIndent">信息框 余弦(1.2) <em>; 返回 0.362358</em></pre>

<h3 id="Tan">正切</h3>
<p>返回 <em>Number</em> 的正切值.</p>
<pre class="Syntax">Value := <span class="func">正切</span>(Number)</pre>
<p><em>Number</em> 必须为弧度值.</p>
<pre class="NoIndent">信息框 正切(1.2) <em>; 返回 2.572152</em></pre>

<h3 id="ASin">反正弦</h3>
<p>返回以弧度表示的反正弦值(其正弦值为 <em>Number</em>).</p>
<pre class="Syntax">Value := <span class="func">反正弦</span>(Number)</pre>
<p>如果 <em>Number</em> 小于 -1 或大于 1, 则抛出异常.</p>
<pre class="NoIndent">信息框 反正弦(0.2) <em>; 返回 0.201358</em></pre>

<h3 id="ACos">反余弦</h3>
<p>返回以弧度表示的反余弦值(其余弦值为 <em>Number</em>).</p>
<pre class="Syntax">Value := <span class="func">反余弦</span>(Number)</pre>
<p>如果 <em>Number</em> 小于 -1 或大于 1, 则抛出异常.</p>
<pre class="NoIndent">信息框 反余弦(0.2) <em>; 返回 1.369438</em></pre>

<h3 id="ATan">反正切</h3>
<p>返回以弧度表示的反正切值(其正切值为 <em>Number</em>).</p>
<pre class="Syntax">Value := <span class="func">反正切</span>(Number)</pre>
<pre class="NoIndent">信息框 反正切(1.2) <em>; 返回 0.876058</em></pre>

<h2 id="Errors">错误处理</h2>
<p>如果传入的参数是非数字的, 或者尝试执行无效操作(如除以0), 则这些函数抛出异常.</p>

</body>
</html>